home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Latest Shareware Programs: Warp / OS-2 WARP - Latest Shareware Programs.iso / dccpro / script.doc < prev    next >
Text File  |  1994-05-18  |  8KB  |  283 lines
  1.  
  2.  
  3.  
  4.                 Dokumentation zur Erstellung eigener Dialoge
  5.                      für den Gebrauch im Anwendermenü
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12. 1. Wofür brauche ich das ?
  13. --------------------------
  14.  
  15.  Die Dialoge vereinfachen die Übergabe von Parametern an Programme.
  16.  Sie erlauben es auch dem unerfahrenen Anwender mit Programmen umzu-
  17.  gehen, die eine komplizierte Parameterübergabe erfordern.
  18.  Ähnliche Dialoge gab  es  auch  schon  bei  DCC  Version  1.8.  Diese
  19.  waren allerdings nicht so frei zu gestalten.
  20.  
  21.  Sie können mit diesen Dialogen beispielsweise Viren-Scanner steuern,
  22.  die sonst eine schwierige Parameterübergabe erfordern. Oder Sie er-
  23.  weitern die im DCC-Pro eingebauten Packer-Optionen nach den eigenen
  24.  Bedürfnissen. (siehe 5. Hinweise)
  25.  
  26.  
  27.  
  28.  
  29.  
  30. 2. Aufbau eines Dialog-Script's
  31. -------------------------------
  32.  
  33.  - Versionsinformation
  34.    DOS-COMMAND-CENTER-PRO 3.0
  35.  - Dialogdefinition (Ausmaße, Überschrift etc.)
  36.    ■ DIALOG
  37.  - Kommandozeile
  38.    ■ COMMANDLINE
  39.  - BEGIN
  40.  - Dialogelemente
  41.  
  42.     ■ CANCELBUTTON
  43.     ■ CHECKBOX
  44.     ■ CONTROL
  45.     ■ INPUT
  46.     ■ LTEXT
  47.     ■ OKBUTTON
  48.     ■ RADIOBUTTON
  49.  
  50.  - END
  51.  
  52.  
  53.  
  54.  
  55.  
  56. 3. Beschreibung
  57. ---------------
  58.  
  59.  DOS-COMMAND-CENTER-PRO 3.0
  60.  
  61.  Die Versionsinformation muss in jedem Script enthalten sein und
  62.  muss in der ersten Zeile stehen.
  63.  
  64.  DIALOG, 0,   5  1 75 21, "Datei(en) packen"
  65.  
  66.  Dies ist die Dialogdefinition. Erst wird der Typ eingetragen. In
  67.  diesem Fall immer  DIALOG.  Danach  wird  die  Nummer  des  Elementes
  68.  eingetragen (In diesem Fall immer 0). Hierauf folgen die Ausmaße  des
  69.  Dialogs in dem Format X1 Y1 X2 Y2
  70.  
  71.                  X1,Y1 ──────────── X2,Y1
  72.                    │                  │
  73.                    │                  │
  74.                  X1,Y2 ──────────── X2,Y2
  75.  
  76.  Sie  können  dabei  vom  Nullpunkt  ausgehen,  da  DCC  den    Dialog
  77.  automatisch auf dem Bildschirm zentriert.
  78.  Nach der Festlegung der Ausmaße folgt die Überschrift, die der Dialog
  79.  bekommen soll.
  80.  
  81.  COMMANDLINE "%4 %5 %6 %7%9 %13 %11"
  82.  
  83.  Diese Zeile beschreibt die Anordnung der Parameter, die die einzelnen
  84.  Dialogelemente zurückgeben.  Jedes  Element  im  Dialog  erhält  eine
  85.  eindeutige  Nummer.  Diese  Nummer  wird  hier  zusammen   mit    dem
  86.  Prozentzeichen "%" eingetragen. DCC ersetzt die Eintragung  dann  mit
  87.  dem entsprechenden Rückgabewert des Elementes. Es macht nur Sinn  die
  88.  Nummern von folgenden Elementtypen hier einzutragen :
  89.  
  90.  - INPUT
  91.  - CHECKBOX
  92.  - RADIOBUTTON
  93.  
  94.  Alle anderen  Elemente  geben  keine  Ergebnisse  zurück.  Falls  ein
  95.  Element keine Rückgabe  zuläßt  oder  z.B.  eine  Eingabezeile  keine
  96.  Eintragungen enthält, so wird die  entsprechende  Eintragung  in  der
  97.  COMMANDLINE einfach entfernt.
  98.  
  99.  Bei diesem Beispieldialog könnte die COMMANDLINE bei  Beendigung  des
  100.  Dialogs folgendermaßen aussehen:
  101.  
  102.  "-ex -3 -r -P -sPASSWORT C:\DCCPRO\TEST.ZIP *.EXE"
  103.     ^  ^    ^   ^   ^              ^           ^
  104.     │  │    │   │   │              │           │
  105.    %4 %5   %6  %7   %9            %13         %11
  106.  
  107.  
  108.  
  109. BEGIN
  110.  
  111.  Jede Dialogdefinition muss von BEGIN-END eingeschlossen sein.
  112.  
  113.  Folgende Elemente stehen zur Verfügung:
  114.  
  115.   - CONTROL
  116.  
  117.     Dies ist das Label/die Überschrift für ein anderes Element.
  118.     Mit diesem Elementtyp können  Sie  beispielsweise  eine  Eingabe-
  119.     zeile beschreiben und anwählen.
  120.  
  121.     Aufbau :
  122.  
  123.     TYP, Nummer des Elementes, Position, Text, verknüpftes Element
  124.  
  125.     Beispiel :
  126.  
  127.     CONTROL      ,  3, 46  2 59  3, "~K~ompression",  4
  128.  
  129.   - RADIOBUTTON
  130.  
  131.     Mit diesem Element wird eine eindeutige Auswahl getroffen. Man
  132.     kann mehrere Einträge zur Auswahl anbieten, es kann jedoch nur
  133.     einer gewählt werden. Es ist weiterhin nicht möglich keinen Eintrag
  134.     auszuwählen.
  135.  
  136.     Aufbau :
  137.  
  138.     TYP, Nummer des Elementes, Position, Anzahl der Einträge,
  139.     Einträge, Rückgabewerte der Einträge
  140.  
  141.     Beispiel :
  142.  
  143.     RADIOBUTTON , 4, 40  3 66  8,  5, "maximal"  "normal"  "schnell"
  144.                   "sehr schnell" "keine", " -ex" " -en" " -ef" " -es" " -e0"
  145.  
  146.   - CHECKBOX
  147.  
  148.     Dieser Typ ist ähnlich aufgebaut, wie der vorherige. Hier können
  149.     jedoch mehrere Einträge angewählt werden. Außerdem ist es hier
  150.     möglich keinen der Einträge auszuwählen.
  151.  
  152.     Der Aufbau ist der gleiche, wie beim Typ RADIOBUTTON
  153.  
  154.     Beispiel :
  155.  
  156.     CHECKBOX   , 5,  4    8  36  10,  2,  "keine  ~3~2-Bit
  157.                 Unterstützung" "k~e~ine DPMI Unterstützung", " -3" " -)"
  158.  
  159.  
  160.  
  161.   - INPUT
  162.  
  163.     Der Typ INPUT stellt eine Eingabezeile dar. Hier können beliebige
  164.     max. 255 Zeichen lange Texte übergeben werden. Der Eingabezeile
  165.     können Standardeintragungen übergeben werden, die beim Aufruf des
  166.     Dialogs in die Eingabezeile eingefügt werden. Hier ist es auch
  167.     möglich mit den von DCC bekannten Platzhaltern "!:!\!.!" zu arbeiten.
  168.     DCC ersetzt diese dann durch den Namen der gerade im Dateifenster
  169.     gewählten Datei.
  170.  
  171.     Aufbau :
  172.  
  173.     TYP, Nummer des Elementes, Position, Standardtext
  174.  
  175.  
  176.     Beispiel :
  177.  
  178.     INPUT        , 11, 16  5 35  6, "!:!\!.!"
  179.  
  180.  
  181.   - LTEXT
  182.  
  183.     Dieser Elementtyp dient ausschließlich dazu, Text darzustellen.
  184.  
  185.     Aufbau :
  186.  
  187.     TYP, Nummer des Elementes, Position, Text
  188.  
  189.     Beispiel :
  190.  
  191.     LTEXT,  3, 46  2 59  3, "Dieser Dialog ist ein Beispieldialog!"
  192.  
  193.   - CANCELBUTTON
  194.  
  195.     Dies ist der Schaltknopf um einen Abbruch des Dialogs zu bewirken.
  196.     Hier können Sie einen beliebigen Text eintragen.
  197.  
  198.     Aufbau :
  199.  
  200.     TYP, Nummer des Elementes, Position, Beschriftung
  201.  
  202.     Beispiel :
  203.  
  204.     CANCELBUTTON ,  1, 53 16 66 18, "~A~bbruch"
  205.  
  206.  
  207.   - OKBUTTON
  208.  
  209.     Dies ist der Schaltknopf um einen Dialog normal zu beenden. Der
  210.     Dialog wird dann geschlossen, die Kommandozeile aufgebaut und
  211.     ausgeführt.
  212.  
  213.     Der Aufbau ist mit dem des CANCELBUTTON indentisch.
  214.  
  215.     Beispiel :
  216.  
  217.     OKBUTTON     ,  2, 40 16 51 18, "~S~tart"
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225. 4. Beispieldialog
  226. -----------------
  227.  
  228. Dieser Dialog dient zum Archivieren von einzelnen oder
  229. markierten Dateien mit PKZIP Version 2.04.
  230. -----------------------------------------------------------------------------
  231.  
  232. DOS-COMMAND-CENTER-PRO 3.0
  233. DIALOG, 0,   5  1 75 21, "Datei(en) packen"
  234. COMMANDLINE "%4 %5 %6 %7%9 %13 %11"
  235. BEGIN
  236.          CONTROL      ,  3, 46  2 59  3, "~K~ompression",  4
  237.          RADIOBUTTON  ,  4, 40  3 66  8,  5, "maximal" "normal" "schnell"
  238.          "sehr schnell" "keine", " -ex" " -en" " -ef" " -es" " -e0"
  239.          CHECKBOX     ,  5,  4  8 36 10,  2, "keine ~3~2-Bit Unterstützung"
  240.          "k~e~ine DPMI Unterstützung", " -3" " -)"
  241.          CHECKBOX     ,  6,  4 15 36 18,  3, "mit ~U~nterverzeichnissen"
  242.          "~m~arkierte Dateien packen" "~V~erzeichnisnamen speichern",
  243.          " -r" " @^ZIP.LST" " -P"
  244.          CHECKBOX     ,  7,  4 12 36 13,  1, "~P~asswort benutzen", " -s"
  245.          CONTROL      ,  8, 40 11 48 12, "Paß~w~ort",  9
  246.          INPUT        ,  9, 40 12 65 13, ""
  247.          CONTROL      , 10,  4  5 15  6, "~D~ateimaske", 11
  248.          INPUT        , 11, 16  5 35  6, "!:!\!.!"
  249.          CONTROL      , 12,  4  3 15  4, "A~r~chivname", 13
  250.          INPUT        , 13, 16  3 35  4, "!:!\!..ZIP"
  251.          CANCELBUTTON ,  1, 53 16 66 18, "~A~bbruch"
  252.          OKBUTTON     ,  2, 40 16 51 18, "~S~tart"
  253. END
  254.  
  255. -----------------------------------------------------------------------------
  256.  
  257. 5. Hinweise
  258. -----------
  259.  
  260. Sie haben die Möglichkeit DCC zu veranlassen eine Dateiliste mit den
  261. gewählten/markierten Dateien zu erstellen. Diese Liste kann dann anderen
  262. Programmen z.B. Packern (PKZip, ARJ etc.) übergeben werden.
  263. Diese Liste wird mit Ascii 94 "^" gekennzeichnet und kann einen beliebigen
  264. Namen haben.
  265.  
  266. Der Einbau einer solchen Dialogdatei im Anwendermenü kann beispielsweise
  267. folgendermaßen aussehen:
  268.  
  269. MENUITEM "~P~acken mit PKZip..." NOKEY "PKZIP &C:\DCCPRO\PKZIP.SCR" _EXECWIN
  270.  
  271. Das Asciizeichen 38 "&" wird dabei dem Namen der Dialogdatei vorangestellt.
  272. Hieran erkennt DCC, daß es sich bei dem folgenden Namen um eine Scriptdatei
  273. handelt.
  274.  
  275. Die Scriptdatei kann an beliebiger Stelle in der Menü-Kommandozeile einge-
  276. tragen werden. Es ist auch möglich nur die Scriptdatei als Kommando einzu-
  277. tragen. Dann wird die Kommandozeile vollständig aus dem Dialog gebildet.
  278.  
  279.  
  280.  
  281.  
  282.  
  283.